home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / neword14.zip / neworder.txt < prev   
Text File  |  1996-07-03  |  8KB  |  201 lines
  1.  
  2.  ┌──────────────────────────────────────────────────────────────────────────┐
  3.  └─────────────────────────── N E W O R D E R ──────────────────────────────┘
  4.  
  5.                    NEWORDER Version 1.4 - 03 July 1996
  6.  
  7.                 (C) Copyright 1995-1996, All Rights Reserved
  8.                      Serge Forget - 1:243/68@fidonet
  9.  
  10.           "Maximus" is a trademark of Scott J. Dudley - Lanius Corp.
  11.  
  12.  ┌──────────────────────────────────────────────────────────────────────────┐
  13.  └─ INTRODUCTION ───────────────────────────────────────────────────────────┘
  14.  
  15.    NEWORDER is a utility for Sysops using Maximus and Maximus/2 version 3.00
  16.    or 3.01 ONLY, written by Scott J. Dudley - Lanius Corp.
  17.  
  18.    - Why I wrote NEWORDER?
  19.  
  20.      Simply because I got tired of renumbering my file and message areas
  21.      manually, everytime I added or deleted areas.  This is something that
  22.      happens often, with sysops joining or leaving numerous networks.  ;)
  23.  
  24.    - What it does?
  25.  
  26.      It renumbers either your MsgArea.ctl or FileArea.ctl files, after you
  27.      have managed to add, delete or reorganized your configuration files.
  28.      This is something that we, sysops, really like to do, fudging with our
  29.      configuration files.  ;)
  30.  
  31.   *NEW:   You can now add the initial value on the command line, like:
  32.           "NEWORDER FileArea.CTL 200"  (Without the quotes).  This will start
  33.           the renumbering of the areas from 200 and up.  Any "%#neworder xxx"
  34.           statements WILL be ignored.
  35.  
  36.           Also, NEWORDER will make an automatic backup copy of your original
  37.           CTL file. ;)  There is no more *.new file, the output file is the
  38.           actual CTL file required, all you have to do is scan the file to
  39.           ensure that it is to your liking and run Silt(p).  ;)
  40.  
  41.           OR, you can use the folowing method:
  42.  
  43.           All that you have to do, is insert one line at the required
  44.           locations, using the keyword "%#neworder" (without the quotes) and
  45.           the starting value, just before the area that the renumbering
  46.           scheme should start, within your original *.CTL files, for example:
  47.  
  48.              %#neworder 1
  49.                  .
  50.                  .
  51.                  .
  52.                  .
  53.              %#neworder 100
  54.  
  55.              FileArea 23
  56.              ACS             Transient
  57.              Desc            (AD) DOS Desktop Programs
  58.              Download        e:\files003\AD-DOSDK\
  59.              Upload          d:\files002\sysop\
  60.              End FileArea
  61.  
  62.              FileArea 24
  63.              ACS             Transient
  64.              Desc            (AD) DOS Games
  65.              Download        d:\files002\AD-DOSGM\
  66.              Upload          d:\files002\sysop\
  67.              End FileArea
  68.  
  69.                .
  70.                .
  71.                .
  72.             %#neworder 200
  73.                .
  74.                .
  75.                .
  76.             etc.....
  77.  
  78.  
  79.         You get the idea.  ;)
  80.  
  81.  
  82.    With this method, whenever NEWORDER encounters this keyword (%#neworder),
  83.    it will reset the Area count to whatever you have chosen.
  84.  
  85.    For example: %#neworder 100 will start numbering areas from 100.
  86.  
  87.    Upon execution, the OUPUT file name will be *.CTL.  So, if you use
  88.    MsgArea.ctl as the input file to process, well, the output file name will
  89.    be MsgArea.CTL, with a backup copy named MsgArea.BAK.  NEWORDER WILL tell
  90.    you what the name of the output file will be.
  91.  
  92.    Enter NEWORDER without any arguments to get the command line reminder.
  93.  
  94.    Also, when using the second method, if the area renumbering tally is
  95.    greater then a NEWORDER keyword, NEWORDER will barf and tell you on which
  96.    line, in your input CTL file, where there is a conflict.  In other words,
  97.    say you have selected a new renumbering count at a certain location, if
  98.    the last area of the previous group is higher then the new renumbering
  99.    number, NEWORDER will tell you.  All you will have to do in this situation,
  100.    is just to increment your new group starting number to a higher value.
  101.  
  102.    After executing NEWORDER:
  103.  
  104.    1-  When satisfied that NEWORDER has done it's job to your liking, delete
  105.        the file MTAG.* in your Maximus root directory.
  106.  
  107.    2-  Delete *.* in your \Max\olr\dats directory.
  108.  
  109.    3-  Run Silt(P) to rebuild your Farea & Marea files, and you are all set.
  110.  
  111.  
  112.    Garanties?  For this price?  You must be kidding!  There is none, niet,
  113.    null, aucune, nada....  All I can say is, it will occupy disk space, and
  114.    that it works here and it may not work for you, but then again it may.  ;)
  115.  
  116.    This program was compiled using Borland C++ v4.00.
  117.  
  118.    This exe file has been compiled for 80386 systems, but should work just
  119.    fine with faster CPU's.  Memory requirements are minimal.
  120.  
  121.    Comments and suggestions are welcome.
  122.  
  123.    I hope that it will make your Maximus management easier, as it does
  124.    for me.
  125.  
  126.  ┌──────────────────────────────────────────────────────────────────────────┐
  127.  └─ COMMAND LINE CONTROLS ──────────────────────────────────────────────────┘
  128.  
  129.  
  130.     Syntax example:  NEWORDER FileArea.ctl
  131.                      NEWORDER FileArea.ctl 100
  132.  
  133.     Syntax example:  NEWORDER MsgArea.ctl
  134.                      NEWORDER MsgArea.ctl 200
  135.  
  136.  
  137.  ┌──────────────────────────────────────────────────────────────────────────┐
  138.  └─ ERROR LEVELS ───────────────────────────────────────────────────────────┘
  139.  
  140.  
  141.                         0 - Normal exit.
  142.                         1 - Input file not found exit.
  143.  
  144.  
  145.  ┌──────────────────────────────────────────────────────────────────────────┐
  146.  └─ DISTRIBUTION ───────────────────────────────────────────────────────────┘
  147.  
  148.     NEWORDER is FREEWARE for NON-commercial users.  You can use it, abuse it,
  149.     break it or what ever you like, but I retain ALL the rights to it.
  150.  
  151.     Also, reverse engineering of any kind or type is prohibited.
  152.  
  153.     For commercial users, contact the author for details.
  154.  
  155.     The Author can be contacted by Fidonet Netmail at 1:243/68, and via the
  156.     following international echomail conferences: in the Maximus support
  157.     conference Muffin; MaxDev; Xenia; and OS2BBS.
  158.  
  159.  ┌──────────────────────────────────────────────────────────────────────────┐
  160.  └─ HISTORY or What's New ──────────────────────────────────────────────────┘
  161.  
  162.     * 03 July 1996 *
  163.  
  164.          - Version 1.4 is released by way of MaxFDN.
  165.          - Since I had some spare time, I implemented something that I wanted
  166.            to do since the first version, automatic backup file creation.  ;)
  167.            Now, all you have to do is run NEWORDER, scan the file for
  168.            correctness and run Silt(p).  See the instructions above.
  169.  
  170.     * 02 July 1996 *
  171.  
  172.          - Version 1.3 is release by way of MaxFDN.
  173.          - Following a few requests and suggestions, I have added an extra
  174.            command line parameter, where you can specify the value of the
  175.            initial file area number.  Of course, any %#neworder keyword will
  176.            be ignored, since the command line value will have priority.  In
  177.            fact, you do not even have to use the "%#neworder" keyword at all
  178.            all.  <WG>
  179.  
  180.     * 03 March 1996 *
  181.  
  182.         - Version 1.2 is released, by way of SDSMAX.
  183.         - Code revision was required in order to get rid of an annoying
  184.           "Null pointer assignment" statement, after running NEWORDER. :(
  185.  
  186.     * 06 December 1995 *
  187.  
  188.         - Version 1.1 is released, by way of SDSMAX.
  189.         - Optimized code.
  190.         - Improved this documentation, some information was missing.
  191.         - Cosmetic changes.
  192.  
  193.     * 19 November 1995 *
  194.  
  195.         - NEWORDER version 1.00 is released, by way of the software
  196.           distribution network SDSMAX.
  197.  
  198.  ┌──────────────────────────────────────────────────────────────────────────┐
  199.  └──────────────────────────────────────────────────────────────────────────┘
  200.  
  201.